Skip to main content

Get Statement Analysis

POST https://api.sat.tausi.africa/v1/tigopesa/upload_tigopesa_pdf

This analyses the pdf and generates the report. The response is in a json format.

Header Requirements

  • Authorization --required

Body Params

  • file --required
  • fullname --required
curl example request
curl -X 'POST' 'https://api.sat.tausi.africa/v1/tigopesa/upload_tigopesa_pdf'
-F fullname=Hussein \
-F 'file=@TigoPesa_7865432_Statement.pdf' \
-H 'Authorization: Bearer XXXXXXXXXXX' \

Response Sample

  1. Status OK Response
200 OK
{
"info": {
"owners_number": 25571350XXXX,
"start_date": "2023-10-02 00:00:00",
"end_date": "2023-12-09 00:00:00",
"total_days": 68,
"total_active_days": 18
},
"profile": {
"current_wallet_balance": 0,
"turnover": 325107.0,
"number_of_transactions": 77
},
"cashin_flow": {
"total_cash-in_flow": 170500.0,
"cash-in_flow_to_turnover_percentage": 52.44,
"cash-in_flow_transactions": 21,
"cash-in_trans_to_total_trans_percentage": 27.27
},
"cashout_flow": {
"Total_cash-out_flow": 154607.0,
"Cash-out_flow_to_turnover_percentage": 47.56,
"Cash-out_flow_transactions": 56,
"Cash-out_trans_to_total_trans_percentage": 72.73
},
"bustisha": {
"Total_amount_repaid": 50966,
"Maximum_amount_repaid": 13178,
"Number_of_times_repaid": 13,
"Last_day_repaid": "2023-12-09T00:00:00",
"Average_amount_repaid_in_the_time_period": 3920.46
},
"luku": {
"Total_amount_used_to_buy_luku": 0,
"Maximum_amount_used_to_buy_luku": 0,
"Number_of_times_bought_luku": 0,
"Last_time_bought_luku": "N/A"
},
"B2W": {
"Total_amount_transferred_from_bank_to_wallet": 90000.0,
"Maximum_amount_transferred_from_bank_to_wallet": 30000.0,
"Number_of_times_trasnferred_from_bank_to_wallet": 11,
"Last_time_transferred_from_bank_to_wallet": "2023-11-08T00:00:00",
"Average_amount_transferred_from_bank_to_wallet": 8181.82
},
"W2B": {
"Total_amount_transferred_from_wallet_to_bank": 0,
"Maximum_amount_transferred_from_wallet_to_bank": 0,
"Number_of_times_trasnferred_from_wallet_to_bank": 0,
"Last_time_transferred_from_wallet_to_bank": "N/A",
"Average_amount_transferred_from_wallet_to_bank": 0
},
"bill": {
"total_amount_used_to_pay_bill": 24500,
"maximum_amount_used_to_pay_bill": 5000,
"Number_of_times_paid_bill": 14,
"last_time_paid_bill": "2023-11-28 00:00:00",
"average_amount_used_to_pay_bill": 1750.0
},
"P2P": {
"total_amount_sent_to_peer": 50260.0,
"maximum_amount_sent_to_peer": 23920,
"Number_of_times_sent_to_peer": 8,
"last_time_sent_to_peer": "2023-10-15 00:00:00",
},
"agent_withdraw": {
"total_amount_withdrawn_via_agent": 6500.0,
"maximum_amount_withdrawn_via_agent": 3600,
"number_of_times_withdrawn_via_agent": 2,
"last_time_withdrawn_via_agent": "2023-10-06 00:00:00",
},
"received_money": {
"total_amount_received_from_peer": 32000.0,
"maximum_amount_received_from_peer": 30000,
"number_of_times_received_from_peer": 2,
"last_time_received_from_peer": "2023-11-28 00:00:00",

},
"airtime_topup": {
"total_amount_toped_up_airtime": 1273.0,
"maximum_amount_toped_up_airtime": 825,
"number_of_times_toped_up_airtime": 2,
"last_time_toped_up_airtime": "2023-10-16 00:00:00"
},
"money_deposit_via_agent": {
"total_amount_deposited_via_agent": 48500,
"maximum_amount_deposited_via_agent": 30000,
"number_of_times_deposited_via_agent": 10,
"average_amount_deposited_via_agent": 4850.0,
"last_time_deposited_via_agent": "2023-12-09 00:00:00"
}
}

  1. Bad Request Response
400 Bad Request
message: "<The specific error message>"

  1. Unprocessable Entity
422 Unprocessable file entity
message: "Unprocessable File Entity"

  1. Rate Limit Error
429 Rate Limited Error
message: "Rate limited resource",
nexttime:"19876543"

Rate Limiting!

Rate Limited Resource Continous Access will lead to blocking an account.

  1. Internal Server Error
500 Internal Server Error
message: "An Internal server error",